home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / bstream.z / bstream
Text File  |  1998-10-20  |  6KB  |  133 lines
  1.  
  2.  
  3.  
  4. bbbbssssttttrrrreeeeaaaammmm((((1111))))                                                          bbbbssssttttrrrreeeeaaaammmm((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      bstream - many buffered filter
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      bbbbssssttttrrrreeeeaaaammmm [----nnnn bufs] [----bbbb size] [----llllttttrrrrvvvvdddd] [----ssss count] [----iiii file] [----oooo file]
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      This command is a filter which buffers input from the input file and
  16.      writes it to the output file.  The command is especially useful for
  17.      reading from or writing to streaming tape drives, where bstream can be
  18.      used as a speed matching program to keep the tape streaming as much as
  19.      possible.
  20.  
  21.      If input or output files are not specified, then _b_s_t_r_e_a_m simply copies
  22.      the standard input to the standard output through multiple buffers.  A
  23.      tape can be written to or read from in this manner, but _b_s_t_r_e_a_m will not
  24.      be able to handle multiple tape copies.  If multiple tapes are involved,
  25.      explicitly specifying the tape device via the ----iiii or ----oooo options will
  26.      enable _b_s_t_r_e_a_m to recover from end of medium indications and request a
  27.      new tape.
  28.  
  29. OOOOPPPPTTTTIIIIOOOONNNNSSSS
  30.      The following options are supported:
  31.  
  32.      ----bbbb _s_i_z_e   specifies the size of buffer to use.  The default size is 64K
  33.                bytes, however any size up to the maximum allowable shared
  34.                memory segment size for the system is allowed.
  35.  
  36.      ----nnnn _c_n_t    Sets the number of buffers to use.  A minimum of two is
  37.                enforced, while the maximum is limited by the number of shared
  38.                memory segments which a process may be attached to
  39.                simultaneously.  More than two buffers can improve performance
  40.                and make the tape more likely to stream.  The default value is
  41.                set to four.
  42.  
  43.      ----llll        Attempt to lock the shared memory buffers into physical memory.
  44.                This will not be possible unless the command is run by the
  45.                superuser.
  46.  
  47.      ----tttt        Attempt to lock program image and stack in physical memory.
  48.                This will not be possible unless the command is run by the
  49.                super user.  The nice value of the _b_s_t_r_e_a_m process is also
  50.                decreased, increasing its scheduling priority.
  51.  
  52.      ----rrrr        Report a summary of the byte throughput achieved by _b_s_t_r_e_a_m for
  53.                the entire transfer as well as for each individual tape if
  54.                multiple tapes are involved.
  55.  
  56.      ----vvvv        Reports each i/o that is done (very verbose).
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. bbbbssssttttrrrreeeeaaaammmm((((1111))))                                                          bbbbssssttttrrrreeeeaaaammmm((((1111))))
  71.  
  72.  
  73.  
  74.      ----dddd        Reports very verbose debugging information.
  75.  
  76.      ----ssss _c_o_u_n_t  Report a summary of the byte throughput achieved by _b_s_t_r_e_a_m
  77.                every _c_o_u_n_t buffers, for both input and output.
  78.  
  79.      ----iiii _f_i_l_e   Specify the input file as an explicit filename, allowing
  80.                recovery from end-of-medium conditions on tapes.  The user will
  81.                be prompted for a new tape.
  82.  
  83.      ----oooo _f_i_l_e   Specify the output file as an explicit filename, allowing
  84.                recovery from end-of-medium conditions on tapes.  The user will
  85.                be prompted for a new tape.
  86.  
  87.      To copy a filesystem onto multiple tapes:
  88.  
  89.           ttttaaaarrrr ccccffff ---- **** |||| bbbbssssttttrrrreeeeaaaammmm ----oooo////ddddeeeevvvv////ttttaaaappppeeee
  90.  
  91.      Recovering an image from tape is just as easy:
  92.  
  93.           bbbbssssttttrrrreeeeaaaammmm ----iiii////ddddeeeevvvv////ttttaaaappppeeee |||| ttttaaaarrrr xxxxffff ----
  94.  
  95.  
  96.      There is a subtle issue involving tapes that should be understood when
  97.      using _b_s_t_r_e_a_m with a tape device.  Usually, a tape device requires that
  98.      the tape be written in even multiples of the block size.  When _b_s_t_r_e_a_m is
  99.      used as a streaming filter (see the above examples) this is not a
  100.      problem, since both _t_a_r(_1) and _c_p_i_o(_1) block the output on natural tape
  101.      boundaries.  To protect the user, _b_s_t_r_e_a_m will round the final write to
  102.      tape up to the nearest tape blocksize boundary, fill the residual of the
  103.      last block with zeros, and print a warning message if rounding up was
  104.      needed.  _b_s_t_r_e_a_m should always be used with a formatter program such as
  105.      _t_a_r or _c_p_i_o when writing to a tape device, since rounding up and filling
  106.      may have unpredictable effects on programs expecting a simple byte
  107.      stream.  No rounding or filling is done when output is not directed to a
  108.      tape device.
  109.  
  110. NNNNOOOOTTTTEEEESSSS
  111.      _b_s_t_r_e_a_m runs only on Silicon Graphics 4D series workstations.  On an
  112.      unloaded 4D60, _b_s_t_r_e_a_m can stream the tape 70 to 80% of the time,
  113.      achieving byte transfer rates around 70K bytes per second.
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.